﻿package com.adsame.interfaces
{
	/**
	 * IAsamControllor 
	 *
	 * 这是一个专门用来控制广告行为的类，可以控制广告的载入、显示、隐藏、销毁或者用户自定义的命令参数。
	 * 广告控制器提供的接口函数包括：
	 *
	 * render 			: 	按照广告配置初始化广告环境，生成所有需要的View容器。
	 * show 			: 	将渲染完成的广告显示在广告场景中。
	 * hide 			: 	将广告隐藏。
	 * destroy 			: 	销毁广告和广告相关的View容器。
	 * adCtrl 			: 	执行广告自定义的命令参数（以扩展广告的富媒体行为）。
	 * 
	 * @package com.adsame.core
	 * @version $id$
	 * @copyright Powered By Adsame 2008-2009 (c)
	 * @author olga 
	 * @license 
	 */
	public interface IAsamControllor
	{
		/**
		 * setParams 
		 * 
		 * @param params : IAsamParams $params : IAsamParams 
		 * @access public
		 * @return void
		 */
		function setParams(params : IAsamParams) : void;

		/**
		 * render 
		 *
		 * 载入广告形式场景模板，并根据系统配置参数生成广告所需容器并渲染广告。
		 * 
		 * @access public
		 * @return void
		 */
		function render(sence : IAsamSence) : void;

		/**
		 * show 
		 *
		 * 将广告显示在广告场景中。
		 * 
		 * @access public
		 * @return void
		 */
		function show () : void;
	}
}

